Creates a keychain reference from a keychain alias.

OSStatus KCMakeKCRefFromAlias (
    AliasHandle keychainAlias, 
    KCRef *keychain
);

keychainAlias

A handle to an alias record of the keychain file. Since the keychain is a file, an alias can be made to the keychain file.

keychain

On return, a pointer to a reference to the keychain specified by the alias in the keychainAlias parameter.

function result

A result code.

SPECIAL CONSIDERATIONS

The memory that the keychain reference occupies must be released by calling the function KCReleaseKeychain when you are finished with it.

VERSION NOTES

Available beginning with Keychain Manager 2.0.

AVAILABILITY

Under evaluation for Carbon. Available in CarbonLib 1.0 and later when KeychainLib 2.0 or later is installed. Exported by CarbonLib 1.0 and later and by KeychainLib 2.0 and later.

© 2000 Apple Computer, Inc. — (Last Updated 4/14/2000)